Class sjl.InsertIterator
All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class sjl.InsertIterator

java.lang.Object
   |
   +----sjl.Iter
           |
           +----sjl.InsertIterator

public class InsertIterator
extends Iter
implements OutputIterator
An iterator adapter that causes all assignment operations (put) to be converted into an insert operation. When the InsertIterator is constructed a container which implements the SequenceContainer is supplied. Currently the List, the Deque and Vector implements SequenceContainer.

Copyright © 1996 Finn Bock

See Also:
List, Deque, Vector

Constructor Index

 o InsertIterator(SequenceContainer, Iterator)
Construct an insert iterator for the container, which convert all assigments (put) into the insert method.

Method Index

 o cmp(Iterator)
Invalid.
 o genericCopy()
Return this.
 o next()
Do nothing.
 o put(Object)
Insert object at the front of the container.
 o setTo(Iterator)
Assign this iterator to another container.

Constructors

 o InsertIterator
  public InsertIterator(SequenceContainer container,
                        Iterator iter)
Construct an insert iterator for the container, which convert all assigments (put) into the insert method. The container must be a SequenceContainer, that is, it must support the insert(Iterator, value) method.

Methods

 o put
  public Object put(Object object)
Insert object at the front of the container.
Parameters:
object - The object that will be inserted in the container
Returns:
object is returned.
 o next
  public Iterator next()
Do nothing. All assignment to this iterator will always be at the front of the container, so advancing the iterator is ignored.
 o cmp
  public boolean cmp(Iterator i)
Invalid. This method is inherited from Iterator, but should not exist in an OutputIterator. XXX: Throw an exception perhaps??.
 o genericCopy
  public Iterator genericCopy()
Return this. Since insert iterators does not maintain any position, there is no need for actually clone the iterator.
 o setTo
  public void setTo(Iterator i)
Assign this iterator to another container. This is faster than creating a new InsertIterator object.

All Packages  Class Hierarchy  This Package  Previous  Next  Index